The sample program is provided as an example of how the StoneTable library can be used. The full source for a similar program is included with the product.
When the program is first started, you should selected the type of demo that you wish. The 2 options are a demo using only the basic features of the StoneTable library or a demo of the combined StoneTable and StoneTableExtra libraries.
In the combined demo, the window will have icons of the trash and clipboard. Selected cells may be dragged with the option key held down to either icon. Also the clipboard icon may be dragged to selected cells.
The menus are the same for either mode of the demo program and are described below.
The file/new menu may be used to open a new window with a new table. This table is a single column with 100 rows.
The file/open menu may be used to open one of the .tbl files in the SampleTables folder. If the monitor supports color and the Option key is helpd down while selecting open, the table will be in color. The reading and processing of the *.tbl files is part of the sample program and is not part of StoneTable.
• The family.tbl file is the one used in the illustrations throughout the StoneTable manual. The "Birth Date" and "Birth Time" columns have cell validations associated with them which allow only date/time formatted data to be entered.
• The source.tbl contains a numbers of cells that have a large number of lines and is useful to illustrate cell scrolling.
• The rainbow.tbl will display a table where each cell is colored differently and then the colors are modified while the table is displayed.
The edit menu may be used to edit text during a cell/title edit. Also columns/rows may be inserted, deleted, or sorted.
cut/copy/paste/clear - standard clipboard operations. In the StoneTable only mode, these are enables only when a cell or title edit has been started by option clicking on a cell. In the combined mode, they will also be available if one or more cells are selected.
insert - select the column or row. The new column or row will be added after this one.
delete - select the column or row to delete.
sort - select a cell in the row or column to use as a key, then select the first and last columns or rows to sort. Hold the option key down to sort descending.
The options menu is used to select various StoneTable options prior to creating a table via the file/new or file/open menu. The icons option will place a palette of icons in the scroll bar of the table. This palette allows "easy" selection of edit cell, scroll cell, extend selection, clear seletion, disjoint selection, and selecting the style of selected cells or all titles (if the option key is down). The right most icon in the icon palette allows font selection of selected cells, the default font (the font used when text is first placed into an empty cell) if no cells are selected, or the title font if the option key is down. If the table is in a color window, additional menu items will be present to allow setting fore/background colors.
StoneTable modes
- click on cell to select
- shift/click to extend selection of cells
- option/click to edit cell/title. Enter to keep changes, command period to abort.
- option/command/click to scroll cell by moving mouse (by lines while in cell, by multiple lines if moved above/below cell)
- click on title, then drag to move column/row
- shift/click on title to select additional columns/rows
- command/click on title, then drag to copy column/row
- click on vertical/horizontal lines to resize column/row
- option/click on icon font menu to change title styles
List of Options
tmBorder - the table has a border and allows columns (and rows) to be selected, moved, copied, and resized. Also allows titles to be specified.
tmDrawIt - when the table needs to be redrawn, do so. If this is not set, the table will be modified but not redrawn until it is set. This has the same effect as TMX_DoDraw.
tmColBlank - do not automatically provide column titles.
tmColLetter - automatically number columns using capital letters (A, B, …, AA, AB, …).
TMX_SetColumnTitle - will override this for specified columns.
tmColNumber - automatically number columns using numbers (1, 2, …,10, 11, …). TMX_SetColumnTitle - will override this for specified columns.
tmRowBlank - do not automatically provide row titles.
tmRowLetter - automatically number rows using capital letters (A, B, …, AA, AB, …).
tmRowNumber - automatically number rows using numbers (1 2 …,10, 11, …).
tmDoHAutoScroll - allow dragging to the left or right of the table to automatically scroll the table.
tmDoVAutoScroll - allow dragging to the top or bottom of the table to automatically scroll the table.
tmNoNilHilite - not currently used, for compatibility only.
tmUseSense - not currently used, for compatibility only.
tmNoRect - not currently used, for compatibility only.
tmNoDisjoint - do not allow selecting cells outside of a single rectangle of cells.
tmNoBox - do not draw rectangle around table.
tmOnlyOne - do not allow extended selects. Columns and rows can still be selected by clicking in the border.
tmIcons - if there is enough space, place the icon palette in either the horizontal or vertical scroll bar. The palette must take up less than 30% of the horizontal or 50% of the vertical scroll bars. Will be ignored if there are no scroll bars.
tmShortScroll; place the scroll bars adjacent to the part of the table where the cell are excluding the title area.
tmHDoubleLine - place a double line between the column titles and the cells.
tmVDoubleLine - place a double line between the row titles and the cells.
tmNotResize - do not allow the columns or rows to be resized by the mouse.
tmNotEditCell - do not allow the cells to be edited in place by the user.
tmNotEditTitle - do not allow the titles to be edited in place by the user.
tmClickColumn - when any cell in a column is clicked in, select the entire column. Only one columns can be selected at a time.
tmClickRow - when any cell in a row is clicked in, select the entire row. Only one row can be selected at a time.
tmNotMove - do not allow move/copy of any column/row.
tmBalloonHelp - display balloon help if balloon help turned on for system.
